# Zenodo Replication Package (Energy Policy submission)

This folder contains a **Zenodo-ready replication package** for the manuscript:
“Do low-carbon city pilots deliver cleaner air? Evidence of delayed gains concentrated in industrial cities”.

## What is included

- `data/derived/`: **derived** city-year panels (CSV) sufficient to reproduce the paper’s tables/figures.
- `code/`: scripts to reproduce the analysis outputs from the derived panels (DID + event studies + robustness).
- `paper/`: LaTeX source (`.tex`), bibliography (`.bib`), and figure files used in the manuscript.
- `output/`: pre-generated markdown reports/figures (optional convenience).
- `environment/`: minimal Python dependency list for re-running the analysis.

## What is NOT included

- No raw archives are included (raw inputs remain local and may be subject to third-party licensing).
- If upstream source data cannot be redistributed, this package provides **instructions and scripts** to reconstruct derived panels locally (see `code/` and `docs/`).

## Quick reproduction (from derived data)

1) Install Python dependencies:

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -r environment/requirements.txt
```

2) Run the main analysis:

```bash
python3 code/run_analysis.py
```

Outputs will be written under `output/`.

## Rebuilding derived panels (requires local raw archives)

If you have access to the original raw archives on your machine, follow the path configuration steps in:
- `docs/raw_data_rebuild_instructions.md`

## How to cite this dataset (Zenodo)

After uploading this package to Zenodo and reserving a DOI, update the manuscript’s Data availability statement and cite the dataset DOI in the references (as required by Energy Policy).
